home *** CD-ROM | disk | FTP | other *** search
/ Inside Multimedia 1994 April / Inside Multimedia CD-ROM (April 1994).iso / prg / gs / gssource.exe / GXHINT1.C < prev    next >
Encoding:
C/C++ Source or Header  |  1992-08-24  |  16.2 KB  |  474 lines
  1. /* Copyright (C) 1990, 1992 Aladdin Enterprises.  All rights reserved.
  2.    Distributed by Free Software Foundation, Inc.
  3.  
  4. This file is part of Ghostscript.
  5.  
  6. Ghostscript is distributed in the hope that it will be useful, but
  7. WITHOUT ANY WARRANTY.  No author or distributor accepts responsibility
  8. to anyone for the consequences of using it or for whether it serves any
  9. particular purpose or works at all, unless he says so in writing.  Refer
  10. to the Ghostscript General Public License for full details.
  11.  
  12. Everyone is granted permission to copy, modify and redistribute
  13. Ghostscript, but only under the conditions described in the Ghostscript
  14. General Public License.  A copy of this license is supposed to have been
  15. given to you along with Ghostscript so you can know your rights and
  16. responsibilities.  It should be in a file named COPYING.  Among other
  17. things, the copyright notice and this notice must be preserved on all
  18. copies.  */
  19.  
  20. /* gxhint1.c */
  21. /* Adobe Type 1 font hint routines */
  22. #include "gx.h"
  23. #include "gserrors.h"
  24. #include "gxarith.h"
  25. #include "gxfixed.h"
  26. #include "gxmatrix.h"
  27. #include "gzstate.h"
  28. #include "gzdevice.h"            /* for gxchar */
  29. #include "gxdevmem.h"            /* ditto */
  30. #include "gxchar.h"
  31. #include "gxfont.h"
  32. #include "gxtype1.h"
  33.  
  34. /* Define the tolerance for testing whether a point is in a zone, */
  35. /* in device pixels.  (Maybe this should be variable??) */
  36. #define stem_tolerance float2fixed(0.05)
  37.  
  38. /* ------ Initialization ------ */
  39.  
  40. typedef zone_table(1) a_zone_table;
  41. private alignment_zone *near
  42.   compute_zones(P6(const gs_matrix_fixed *, const font_hints *,
  43.     const a_zone_table *, const a_zone_table *, alignment_zone *, int));
  44. private void near
  45.   transform_zone(P4(const gs_matrix_fixed *, const font_hints *,
  46.     const float *, alignment_zone *));
  47.  
  48. /* Compute the font-level hints from the font and the matrix. */
  49. /* We should cache this with the font/matrix pair.... */
  50. void
  51. compute_font_hints(font_hints *pfh, const gs_matrix_fixed *pmat,
  52.   const gs_type1_data *pdata)
  53. {    int h_count = 0, v_count = 0;
  54.     alignment_zone *zp = &pfh->a_zones[0];
  55.     /* Figure out which hints, if any, to use, */
  56.     /* and the orientation of the axes. */
  57.     pfh->axes_swapped = pfh->x_inverted = pfh->y_inverted = 0;
  58.     pfh->use_x_hints = pfh->use_y_hints = 0;
  59.     if ( is_fzero(pmat->xy) )
  60.         pfh->y_inverted = is_fneg(pmat->yy),
  61.         pfh->use_y_hints = 1;
  62.     else if ( is_fzero(pmat->xx) )
  63.         pfh->y_inverted = is_fneg(pmat->xy),
  64.         pfh->axes_swapped = 1,
  65.         pfh->use_y_hints = 1;
  66.     if ( is_fzero(pmat->yx) )
  67.         pfh->x_inverted = is_fneg(pmat->xx),
  68.         pfh->use_x_hints = 1;
  69.     else if ( is_fzero(pmat->yy) )
  70.         pfh->x_inverted = is_fneg(pmat->yx),
  71.         pfh->axes_swapped = 1,
  72.         pfh->use_x_hints = 1;
  73.     if_debug6('1', "[1]ctm=[%g %g %g %g %g %g]\n",
  74.           pmat->xx, pmat->xy, pmat->yx, pmat->yy,
  75.           pmat->tx, pmat->ty);
  76.     if_debug5('1', "[1]swapped=%d, x/y_hints=%d,%d, x/y_inverted=%d,%d\n",
  77.           pfh->axes_swapped, pfh->use_x_hints, pfh->use_y_hints,
  78.           pfh->x_inverted, pfh->y_inverted);
  79.     /* Transform the actual hints. */
  80.     if ( pfh->use_x_hints )
  81.     {    gs_fixed_point hw;
  82.         fixed *hp = (pfh->axes_swapped ? &hw.y : &hw.x);
  83.         int i;
  84.         if ( pdata->StdHW.count )
  85.         {    gs_distance_transform2fixed(pmat,
  86.                 (float)pdata->StdHW.data[0], 0.0, &hw);
  87.             pfh->snap_h.data[0] = any_abs(*hp);
  88.             if_debug1('1', "[1]snap_h[0]=%g\n",
  89.                   fixed2float(pfh->snap_h.data[0]));
  90.             h_count = 1;
  91.         }
  92.         for ( i = 0; i < pdata->StemSnapH.count; i++ )
  93.         {    gs_distance_transform2fixed(pmat,
  94.                 (float)pdata->StemSnapH.data[i], 0.0, &hw);
  95.             pfh->snap_h.data[h_count++] = any_abs(*hp);
  96.             if_debug2('1', "[1]snap_h[%d]=%g\n", h_count - 1,
  97.                   fixed2float(pfh->snap_h.data[h_count - 1]));
  98.         }
  99.     }
  100.     if ( pfh->use_y_hints )
  101.     {    gs_fixed_point vw;
  102.         fixed *vp = (pfh->axes_swapped ? &vw.x : &vw.y);
  103.         int i;
  104.         /* Convert blue parameters to device pixels. */
  105.         gs_distance_transform2fixed(pmat, 0.0,
  106.                         (float)pdata->BlueFuzz, &vw);
  107.         pfh->blue_fuzz = any_abs(*vp);
  108.         gs_distance_transform2fixed(pmat, 0.0, 1.0, &vw);
  109.         pfh->suppress_overshoot = any_abs(*vp) < pdata->BlueScale;
  110.         gs_distance_transform2fixed(pmat, 0.0, pdata->BlueShift, &vw);
  111.         pfh->blue_shift = any_abs(*vp);
  112.         /* Tweak up blue_shift if it is less than half a pixel. */
  113.         /* See the discussion of BlueShift in section 5.7 of */
  114.         /* "Adobe Type 1 Font Format." */
  115.         if ( pfh->blue_shift < fixed_half )
  116.             pfh->blue_shift = fixed_half;
  117.         if_debug5('1', "[1]blue_fuzz=%d->%g, blue_shift=%g->%g, sup_ov=%d\n",
  118.               pdata->BlueFuzz, fixed2float(pfh->blue_fuzz),
  119.               pdata->BlueShift, fixed2float(pfh->blue_shift),
  120.               pfh->suppress_overshoot);
  121.         zp = compute_zones(pmat, pfh,
  122.                    (const a_zone_table *)&pdata->BlueValues,
  123.                    (const a_zone_table *)&pdata->FamilyBlues,
  124.                    zp, 1);
  125.         zp = compute_zones(pmat, pfh,
  126.                    (const a_zone_table *)&pdata->OtherBlues,
  127.                    (const a_zone_table *)&pdata->FamilyOtherBlues,
  128.                    zp, max_OtherBlues);
  129.         if ( pdata->StdVW.count )
  130.         {    gs_distance_transform2fixed(pmat, 0.0,
  131.                 (float)pdata->StdVW.data[0], &vw);
  132.             pfh->snap_v.data[0] = any_abs(*vp);
  133.             if_debug1('1', "[1]snap_v[0]=%g\n",
  134.                   fixed2float(pfh->snap_v.data[0]));
  135.             v_count = 1;
  136.         }
  137.         for ( i = 0; i < pdata->StemSnapV.count; i++ )
  138.         {    gs_distance_transform2fixed(pmat, 0.0,
  139.                 (float)pdata->StemSnapV.data[i], &vw);
  140.             pfh->snap_v.data[v_count++] = any_abs(*vp);
  141.             if_debug2('1', "[1]snap_v[%d]=%g\n", v_count - 1,
  142.                   fixed2float(pfh->snap_v.data[v_count - 1]));
  143.         }
  144.     }
  145.     pfh->snap_h.count = h_count;
  146.     pfh->snap_v.count = v_count;
  147.     pfh->a_zone_count = zp - &pfh->a_zones[0];
  148. }
  149.  
  150. /* Compute the alignment zones for one set of 'blue' values. */
  151. private alignment_zone *near
  152. compute_zones(const gs_matrix_fixed *pmat, const font_hints *pfh,
  153.   const a_zone_table *blues, const a_zone_table *family_blues,
  154.   alignment_zone *zp, int bottom_count)
  155. {    int i;
  156.     fixed fuzz = pfh->blue_fuzz;
  157.     int inverted =
  158.         (pfh->axes_swapped ? pfh->x_inverted : pfh->y_inverted);
  159.     for ( i = 0; i < blues->count; i += 2, zp++ )
  160.     {    const float *vp = &blues->data[i];
  161.         zp->is_top_zone = i >> 1 >= bottom_count;
  162.         transform_zone(pmat, pfh, vp, zp);
  163.         if_debug5('1', "[1]blues[%d]=%g,%g -> %g,%g\n",
  164.               i >> 1, vp[0], vp[1],
  165.               fixed2float(zp->v0), fixed2float(zp->v1));
  166.         if ( i < family_blues->count )
  167.         {    /* Check whether family blues should supersede. */
  168.             alignment_zone fz;
  169.             const float *fvp = &family_blues->data[i];
  170.             fixed diff;
  171.             transform_zone(pmat, pfh, fvp, &fz);
  172.             if_debug5('1', "[1]f_blues[%d]=%g,%g -> %g,%g\n",
  173.                   i >> 1, fvp[0], fvp[1],
  174.                   fixed2float(fz.v0), fixed2float(fz.v1));
  175.             diff = (zp->v1 - zp->v0) - (fz.v1 - fz.v0);
  176.             if ( diff > -fixed_1 && diff < fixed_1 )
  177.                 zp->v0 = fz.v0, zp->v1 = fz.v1;
  178.         }
  179.         /* Compute the flat position, and add the fuzz. */
  180.         if ( (inverted ? zp->is_top_zone : !zp->is_top_zone) )
  181.             zp->flat = zp->v1, zp->v0 -= fuzz;
  182.         else
  183.             zp->flat = zp->v0, zp->v1 += fuzz;
  184.     }
  185.     return zp;
  186. }
  187.  
  188. /* Transform a single alignment zone to device coordinates, */
  189. /* taking axis swapping into account. */
  190. private void near
  191. transform_zone(const gs_matrix_fixed *pmat, const font_hints *pfh,
  192.   const float *vp, alignment_zone *zp)
  193. {    gs_fixed_point p0, p1;
  194.     fixed v0, v1;
  195.     gs_point_transform2fixed(pmat, 0.0, vp[0], &p0);
  196.     gs_point_transform2fixed(pmat, 0.0, vp[1], &p1);
  197.     if ( pfh->axes_swapped ) v0 = p0.x, v1 = p1.x;
  198.     else v0 = p0.y, v1 = p1.y;
  199.     if ( v0 <= v1 ) zp->v0 = v0, zp->v1 = v1;
  200.     else zp->v0 = v1, zp->v1 = v0;
  201. }
  202.  
  203. /* Reset the stem hints. */
  204. void
  205. reset_stem_hints(register gs_type1_state *pis)
  206. {    pis->hstem_hints.count = 0;
  207.     pis->hstem_hints.current = &pis->hstem_hints.data[0];
  208.     pis->vstem_hints.count = 0;
  209.     pis->vstem_hints.current = &pis->vstem_hints.data[0];
  210. }
  211.  
  212. /* ------ Add hints ------ */
  213.  
  214. private stem_hint *near type1_stem(P3(stem_hint_table *, fixed, fixed));
  215. private fixed near find_snap(P2(fixed, const stem_snap_table *));
  216. private alignment_zone *near
  217. find_zone(P3(gs_type1_state *, fixed, fixed));
  218.  
  219. #define c_fixed(d, c) m_fixed(fixed2int_var(d), c, pis->fc)
  220.  
  221. /* Add a horizontal stem hint. */
  222. void
  223. type1_hstem(register gs_type1_state *pis, fixed y, fixed dy)
  224. {    stem_hint *psh;
  225.     alignment_zone *pz;
  226.     fixed v, dv, adj_dv;
  227.     fixed vtop, vbot;
  228.     fixed center, diff_v, diff2_dv;
  229.     if ( !pis->fh.use_y_hints ) return;
  230.     y += pis->lsb.y;
  231.     if ( pis->fh.axes_swapped )
  232.         v = pis->vs_offset.x + c_fixed(y, pis->fc.yx) +
  233.             pis->pgs->ctm.tx_fixed,
  234.         dv = c_fixed(dy, pis->fc.yx);
  235.     else
  236.         v = pis->vs_offset.y + c_fixed(y, pis->fc.yy) +
  237.             pis->pgs->ctm.ty_fixed,
  238.         dv = c_fixed(dy, pis->fc.yy);
  239.     if ( dy < 0 )
  240.         vbot = v + dv, vtop = v;
  241.     else
  242.         vbot = v, vtop = v + dv;
  243.     if ( dv < 0 ) v += dv, dv = -dv;
  244.     psh = type1_stem(&pis->hstem_hints, v, dv);
  245.     if ( psh == 0 ) return;
  246.     adj_dv = find_snap(dv, &pis->fh.snap_h);
  247.     pz = find_zone(pis, vbot, vtop);
  248.     if ( pz != 0 )
  249.     {    /* Use the alignment zone to align the outer stem edge. */
  250.         int inverted =
  251.           (pis->fh.axes_swapped ? pis->fh.x_inverted : pis->fh.y_inverted);
  252.         int adjust_v1 =
  253.           (inverted ? !pz->is_top_zone : pz->is_top_zone);
  254.         fixed flat_v = pz->flat;
  255.         fixed overshoot =
  256.             (pz->is_top_zone ? vtop - flat_v : flat_v - vbot);
  257.         fixed pos_over =
  258.             (inverted ? -overshoot : overshoot);
  259.         fixed ddv = adj_dv - dv;
  260.         fixed shift = fixed_rounded(flat_v) - flat_v;
  261.         if ( pos_over > 0 )
  262.         { if ( pos_over < pis->fh.blue_shift || pis->fh.suppress_overshoot )
  263.           {    /* Character is small, suppress overshoot. */
  264.             if_debug0('1', "[1]suppress overshoot\n");
  265.             if ( pz->is_top_zone )
  266.                 shift -= overshoot;
  267.             else
  268.                 shift += overshoot;
  269.           }
  270.           else if ( pos_over < fixed_1 )
  271.           {    /* Enforce overshoot. */
  272.             if_debug0('1', "[1]enforce overshoot\n");
  273.             if ( overshoot < 0 )
  274.                 overshoot = -fixed_1 - overshoot;
  275.             else
  276.                 overshoot = fixed_1 - overshoot;
  277.             if ( pz->is_top_zone )
  278.                 shift += overshoot;
  279.             else
  280.                 shift -= overshoot;
  281.           }
  282.         }
  283.         if ( adjust_v1 )
  284.             psh->dv1 = shift, psh->dv0 = shift - ddv;
  285.         else
  286.             psh->dv0 = shift, psh->dv1 = shift + ddv;
  287.         if_debug4('1', "[1]flat_v = %g, overshoot = %g, dv=%g,%g\n",
  288.               fixed2float(flat_v), fixed2float(overshoot),
  289.               fixed2float(psh->dv0), fixed2float(psh->dv1));
  290.         return;
  291.     }
  292.     /* Align the stem so its edges fall on pixel boundaries, */
  293.     /* moving the center as little as possible. */
  294.     center = v + arith_rshift_1(dv);
  295.     if ( adj_dv & fixed_1 )
  296.     {    /* Odd width, align center on half-pixel. */
  297.         center += fixed_half;
  298.     }
  299.     diff_v = fixed_rounded(center) - center;
  300.     diff2_dv = arith_rshift_1(adj_dv - dv);
  301.     psh->dv0 = diff_v - diff2_dv;
  302.     psh->dv1 = diff_v + diff2_dv;
  303.     if_debug6('1', "[1]hstem %g,%g -> %g,%g ; d = %g,%g\n",
  304.           fixed2float(y), fixed2float(dy),
  305.           fixed2float(v), fixed2float(dv),
  306.           fixed2float(psh->dv0), fixed2float(psh->dv1));
  307. }
  308.  
  309. /* Add a vertical stem hint. */
  310. void
  311. type1_vstem(register gs_type1_state *pis, fixed x, fixed dx)
  312. {    stem_hint *psh;
  313.     fixed v, dv, adj_dv;
  314.     fixed center, diff_v, diff2_dv;
  315.     if ( !pis->fh.use_x_hints ) return;
  316.     x += pis->lsb.x;
  317.     if ( pis->fh.axes_swapped )
  318.         v = pis->vs_offset.y + c_fixed(x, pis->fc.xy) +
  319.             pis->pgs->ctm.ty_fixed,
  320.         dv = c_fixed(dx, pis->fc.xy);
  321.     else
  322.         v = pis->vs_offset.x + c_fixed(x, pis->fc.xx) +
  323.             pis->pgs->ctm.tx_fixed,
  324.         dv = c_fixed(dx, pis->fc.xx);
  325.     if ( dv < 0 ) v += dv, dv = -dv;
  326.     psh = type1_stem(&pis->vstem_hints, v, dv);
  327.     if ( psh == 0 ) return;
  328.     adj_dv = find_snap(dv, &pis->fh.snap_v);
  329.     if ( pis->pdata->ForceBold && adj_dv < fixed_1 )
  330.         adj_dv = fixed_1;
  331.     /* Align the stem so its edges fall on pixel boundaries, */
  332.     /* moving the center as little as possible. */
  333.     center = v + arith_rshift_1(dv);
  334.     if ( adj_dv & fixed_1 )
  335.     {    /* Odd width, align center on half-pixel. */
  336.         center += fixed_half;
  337.     }
  338.     diff_v = fixed_rounded(center) - center;
  339.     diff2_dv = arith_rshift_1(adj_dv - dv);
  340.     psh->dv0 = diff_v - diff2_dv;
  341.     psh->dv1 = diff_v + diff2_dv;
  342.     if_debug6('1', "[1]vstem %g,%g -> %g,%g ; d = %g,%g\n",
  343.           fixed2float(x), fixed2float(dx),
  344.           fixed2float(v), fixed2float(dv),
  345.           fixed2float(psh->dv0), fixed2float(psh->dv1));
  346. }
  347.  
  348. /* Add a stem hint, keeping the table sorted. */
  349. /* Return the stem hint pointer, or 0 if the table is full. */
  350. private stem_hint *near
  351. type1_stem(stem_hint_table *psht, fixed v0, fixed d)
  352. {    stem_hint *bot = &psht->data[0];
  353.     stem_hint *top = bot + psht->count;
  354.     if ( psht->count >= max_stems ) return 0;
  355.     while ( top > bot && v0 < top[-1].v0 )
  356.        {    *top = top[-1];
  357.         top--;
  358.        }
  359.     /* Add a little fuzz for insideness testing. */
  360.     top->v0 = v0 - stem_tolerance;
  361.     top->v1 = v0 + d + stem_tolerance;
  362.     psht->count++;
  363.     return top;
  364. }
  365.  
  366. /* Compute the adjusted width of a stem. */
  367. private fixed near
  368. find_snap(fixed dv, const stem_snap_table *psst)
  369. {    fixed best = fixed_1 * 2;
  370.     fixed adj_dv;
  371.     int i;
  372.     for ( i = 0; i < psst->count; i++ )
  373.     {    fixed diff = psst->data[i] - dv;
  374.         if ( any_abs(diff) < any_abs(best) )
  375.         {    if_debug3('1', "[1]snap %g to [%d]%g\n",
  376.                   fixed2float(dv), i,
  377.                   fixed2float(psst->data[i]));
  378.             best = diff;
  379.         }
  380.     }
  381.     adj_dv = fixed_rounded(any_abs(best) <= fixed_1 ? dv + best : dv);
  382.     if ( adj_dv == 0 ) adj_dv = fixed_1;
  383.     if_debug2('1', "[1]snap %g to %g\n",
  384.           fixed2float(dv), fixed2float(adj_dv));
  385.     return adj_dv;
  386. }
  387.  
  388. /* Find the applicable alignment zone for a stem, if any. */
  389. /* vbot and vtop are the bottom and top of the stem, */
  390. /* but without interchanging if the y axis is inverted. */
  391. private alignment_zone *near
  392. find_zone(gs_type1_state *pis, fixed vbot, fixed vtop)
  393. {    alignment_zone *pz;
  394.     for ( pz = &pis->fh.a_zones[pis->fh.a_zone_count]; --pz >= &pis->fh.a_zones[0]; )
  395.     {    fixed v = (pz->is_top_zone ? vtop : vbot);
  396.         if ( v >= pz->v0 && v <= pz->v1 )
  397.         {    if_debug2('1', "[1]stem crosses %s-zone %d\n",
  398.                   (pz->is_top_zone ? "top" : "bottom"),
  399.                   (int)(pz - &pis->fh.a_zones[0]));
  400.             return pz;
  401.         }
  402.     }
  403.     return 0;
  404. }
  405.  
  406. /* ------ Apply hints ------ */
  407.  
  408. private stem_hint *near
  409. search_hints(P2(stem_hint_table *, fixed));
  410.  
  411. /* Adjust a point according to the relevant hints. */
  412. /* x and y are the current point in device space after moving; */
  413. /* dx and dy are the delta components in character space. */
  414. void
  415. find_stem_hints(gs_type1_state *pis, fixed x, fixed y,
  416.   fixed dx, fixed dy, gs_fixed_point *ppt)
  417. {    ppt->x = x, ppt->y = y;
  418.     if ( pis->in_dotsection ) return;
  419.     /* Note that if use_x/y_hints is false, */
  420.     /* no entries ever get made in the stem hint tables, */
  421.     /* so we don't have to check those flags here. */
  422.     /* Check the vertical stem hints. */
  423.     if ( pis->vstem_hints.count )
  424.     {    fixed *pv = (pis->fh.axes_swapped ? &ppt->y : &ppt->x);
  425.         stem_hint *ph = search_hints(&pis->vstem_hints, *pv);
  426.         if ( ph != 0 )
  427.         {    /* Decide which side of the stem we are on. */
  428.             /* If we're moving horizontally, just use the */
  429.             /* x coordinate; otherwise, assume outside */
  430.             /* edges move clockwise and inside edges move */
  431.             /* counter-clockwise.  (This algorithm was */
  432.             /* taken from the IBM X11R5 rasterizer; I'm not */
  433.             /* sure I believe it.) */
  434. #define adjust_stem(pv, dxy, ph, inverted)\
  435.   *pv +=\
  436.     ((/*dy == 0 ?*/ *pv < arith_rshift_1(ph->v0 +\
  437.       ph->v1) /*: pis->fh.y_inverted ? dy < 0 : dy > 0*/) ?\
  438.      ph->dv0 : ph->dv1)
  439.             if_debug2('1', "[1]use vstem %d: %g",
  440.                   (int)(ph - &pis->vstem_hints.data[0]),
  441.                   fixed2float(*pv));
  442.             adjust_stem(pv, dy, ph, pis->fh.y_inverted);
  443.             if_debug1('1', " -> %g\n", fixed2float(*pv));
  444.         }
  445.     }
  446.     /* Check the horizontal stem hints. */
  447.     if ( pis->hstem_hints.count )
  448.     {    fixed *pv = (pis->fh.axes_swapped ? &ppt->x : &ppt->y);
  449.         stem_hint *ph = search_hints(&pis->hstem_hints, *pv);
  450.         if ( ph != 0 )
  451.         {    if_debug2('1', "[1]use hstem %d: %g",
  452.                   (int)(ph - &pis->hstem_hints.data[0]),
  453.                   fixed2float(*pv));
  454.             adjust_stem(pv, dx, ph, pis->fh.x_inverted);
  455.             if_debug1('1', " -> %g\n", fixed2float(*pv));
  456.         }
  457.     }
  458.     return;
  459. #undef adjust_stem
  460. }
  461.  
  462. /* Search one hint table for an adjustment. */
  463. private stem_hint *near
  464. search_hints(stem_hint_table *psht, fixed v)
  465. {    stem_hint *ph = psht->current;
  466.     if ( v >= ph->v0 && v <= ph->v1 ) return ph;
  467.     /* We don't bother with binary or even up/down search, */
  468.     /* because there won't be very many hints. */
  469.     for ( ph = &psht->data[psht->count]; --ph >= &psht->data[0]; )
  470.       if ( v >= ph->v0 && v <= ph->v1 )
  471.         return (psht->current = ph);
  472.     return 0;
  473. }
  474.